home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / ilbuff.z / ilbuff
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiillllbbbbuuuuffffffffeeeerrrr((((3333GGGG))))                                                      iiiillllbbbbuuuuffffffffeeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllbbbbuuuuffffffffeeeerrrr - allocates framebuffer space to hold temporary image processing
  10.      results
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 ffffuuuunnnnccccttttiiiioooonnnn iiiillllbbbbffffffffrrrr((((bbbbffffffffrrrrssss))))
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 bbbbffffffffrrrrssss
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _b_u_f_f_e_r_s    the number of 12bit-per-component screen-sized buffers
  18.                 requested
  19.  
  20. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  21.      The returned value of the function is the number of buffers granted.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      iiiillllbbbbuuuuffffffffeeeerrrr attempts to allocte buffers 12bit/component color buffers that
  25.      span the entire display surface.
  26.  
  27.      On the RealityEngine, a 12bit/componenent color buffer consumes 3 16bit
  28.      framebuffer words.  A count of the deepest pixel currently used is
  29.      maintained by the Kernel graphics driver. The count is always at least 9
  30.      16bit words, the value required to support 2 12bit/component color
  31.      buffers and a Z/stencil buffer.  The remainder of the pixel depth can be
  32.      allocated to the caller for use as temporary image processing storage.
  33.  
  34.      Any requests by other graphics contexts to use pixel depths that would
  35.      extend into the allocated buffer are denied until the buffer is
  36.      explicitly freed by ilbuffer(0), or the graphics context (window) is
  37.      destroyed. Equivalently, if a graphics context uses features that require
  38.      all of the pixel depth, ilbuffer may return 0. The resource is not
  39.      virtualized and is allocated first come, first served.
  40.  
  41.      For example on a RealityEngine running with small pixel depth, 12 16bit
  42.      framebuffer words available for graphics features. Six are required for
  43.      double color buffers and three for Z/stencil. That leaves three that
  44.      could be alloced for 1 ilbuffer if no other program has allocated a pixel
  45.      depth greater than 9 impwords.
  46.  
  47.      On a RealityEngine running with medium pixel depth, 28 16bit framebuffer
  48.      words are available for graphics features. Nine are required for basic
  49.      double buffered Zbuffer operation, so 19 16bit words are available to be
  50.      allocated as 6 ilbuffers if no other program has allocated a pixel depth
  51.      greater than 9 16bit framebuffer words.
  52.  
  53.      Multiple contexts may allocate the same framebuffer space through calls
  54.      to ilbuffer, but the ilbuffer is not virtualized (context switched), so
  55.      user contexts must synchronize the use of this buffer themselves. The
  56.      ImageLibrary uses this feature, so concurrent use of the ImageLibrary
  57.      when it is using hardware acceleration and user programs that use this
  58.      feature will not necessarily work together correctly. One possibility is
  59.      to cause the ImageLibrary to use only the CPU while user programs use
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllbbbbuuuuffffffffeeeerrrr((((3333GGGG))))                                                      iiiillllbbbbuuuuffffffffeeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      this feature.
  75.  
  76.      The ilbuffers can be selected for drawing with ildraw or as a readsource
  77.      for pixel copies or framebuffer to texture loads with readsource
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80. NNNNOOOOTTTTEEEE
  81.      This routine is available only in immediate mode, and only on
  82.      RealityEngine running 5.0.1 or later.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.